DMUnmirrorDevice

DMUnmirrorDevice
Header:	Displays.h		Carbon status:	Supported

Turns off video mirroring.

OSErr DMUnmirrorDevice (
    GDHandle gDevice, 
    Handle displayState
);

gDevice: A handle to the GDevice structure for the video device on which you no longer wish to mirror the pixel image of another device.
displayState: If your application called DMBeginConfigureDisplays, you must pass the displayState handle obtained. Otherwise pass NULL in this parameter.

function result: A result code.

DISCUSSION

When the function DMUnmirrorDevice completes, the display controlled by the video device specified in the gDevice parameter no longer contains the mirror image of another display.

Your application should leave control of video mirroring to the user. However, if video mirroring is useful for your application (for example, if your application displays on-screen presentations), you might provide a control so that the user can switch to video mirroring directly from your application. In this case, the function DMMirrorDevices is useful for switching video mirroring on, and DMUnmirrorDevice function is useful for switching it off again.

SPECIAL CONSIDERATIONS

Because this function may move or purge memory blocks or access handles, you cannot call it at interrupt time.

AVAILABILITY

Supported in Carbon. Available in CarbonLib 1.0 and later when InterfaceLib 7.5 or later is installed. Exported by CarbonLib 1.0 and later and by InterfaceLib 7.5 and later.